home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat3 / Tk / label.z / label
Encoding:
Text File  |  1998-10-30  |  7.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. llllaaaabbbbeeeellll((((3333TTTTkkkk))))                                                          llllaaaabbbbeeeellll((((3333TTTTkkkk))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      label - Create and manipulate label widgets
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      llllaaaabbbbeeeellll _p_a_t_h_N_a_m_e ?_o_p_t_i_o_n_s?
  13.  
  14. SSSSTTTTAAAANNNNDDDDAAAARRRRDDDD OOOOPPPPTTTTIIIIOOOONNNNSSSS
  15.      aaaannnncccchhhhoooorrrr       ffffoooonnnntttt                iiiimmmmaaaaggggeeee    ttttaaaakkkkeeeeFFFFooooccccuuuussss                      |
  16.      bbbbaaaacccckkkkggggrrrroooouuuunnnndddd   ffffoooorrrreeeeggggrrrroooouuuunnnndddd          jjjjuuuussssttttiiiiffffyyyy  tttteeeexxxxtttt                           |
  17.      bbbbiiiittttmmmmaaaapppp       hhhhiiiigggghhhhlllliiiigggghhhhttttBBBBaaaacccckkkkggggrrrroooouuuunnnndddd ppppaaaaddddXXXX     tttteeeexxxxttttVVVVaaaarrrriiiiaaaabbbblllleeee                   |
  18.      bbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh  hhhhiiiigggghhhhlllliiiigggghhhhttttCCCCoooolllloooorrrr      ppppaaaaddddYYYY     uuuunnnnddddeeeerrrrlllliiiinnnneeee                      |
  19.      ccccuuuurrrrssssoooorrrr       hhhhiiiigggghhhhlllliiiigggghhhhttttTTTThhhhiiiicccckkkknnnneeeessssssss  rrrreeeelllliiiieeeeffff   wwwwrrrraaaappppLLLLeeeennnnggggtttthhhh
  20.  
  21.      See the ``options'' manual entry for details on the standard options.
  22.  
  23. WWWWIIIIDDDDGGGGEEEETTTT----SSSSPPPPEEEECCCCIIIIFFFFIIIICCCC OOOOPPPPTTTTIIIIOOOONNNNSSSS
  24.      Name:           hhhheeeeiiiigggghhhhtttt
  25.      Class:          HHHHeeeeiiiigggghhhhtttt
  26.      Command-Line Switch:----hhhheeeeiiiigggghhhhtttt
  27.  
  28.           Specifies a desired height for the label.  If an image or bitmap is
  29.           being displayed in the label then the value is in screen units (i.e.
  30.           any of the forms acceptable to TTTTkkkk____GGGGeeeettttPPPPiiiixxxxeeeellllssss); for text it is in
  31.           lines of text.  If this option isn't specified, the label's desired
  32.           height is computed from the size of the image or bitmap or text
  33.           being displayed in it.
  34.  
  35.      Name:           wwwwiiiiddddtttthhhh
  36.      Class:          WWWWiiiiddddtttthhhh
  37.      Command-Line Switch:----wwwwiiiiddddtttthhhh
  38.  
  39.           Specifies a desired width for the label.  If an image or bitmap is
  40.           being displayed in the label then the value is in screen units (i.e.
  41.           any of the forms acceptable to TTTTkkkk____GGGGeeeettttPPPPiiiixxxxeeeellllssss); for text it is in
  42.           characters.  If this option isn't specified, the label's desired
  43.           width is computed from the size of the image or bitmap or text being
  44.           displayed in it.
  45.  
  46.  
  47. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  48.      The llllaaaabbbbeeeellll command creates a new window (given by the _p_a_t_h_N_a_m_e argument)
  49.      and makes it into a label widget.  Additional options, described above,
  50.      may be specified on the command line or in the option database to
  51.      configure aspects of the label such as its colors, font, text, and
  52.      initial relief.  The llllaaaabbbbeeeellll command returns its _p_a_t_h_N_a_m_e argument.  At the
  53.      time this command is invoked, there must not exist a window named
  54.      _p_a_t_h_N_a_m_e, but _p_a_t_h_N_a_m_e's parent must exist.
  55.  
  56.      A label is a widget that displays a textual string, bitmap or image.  If |
  57.      text is displayed, it must all be in a single font, but it can occupy    |
  58.      multiple lines on the screen (if it contains newlines or if wrapping     |
  59.      occurs because of the wwwwrrrraaaappppLLLLeeeennnnggggtttthhhh option) and one of the characters may   |
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. llllaaaabbbbeeeellll((((3333TTTTkkkk))))                                                          llllaaaabbbbeeeellll((((3333TTTTkkkk))))
  71.  
  72.  
  73.  
  74.      optionally be underlined using the uuuunnnnddddeeeerrrrlllliiiinnnneeee option.  The label can be
  75.      manipulated in a few simple ways, such as changing its relief or text,
  76.      using the commands described below.
  77.  
  78.  
  79. WWWWIIIIDDDDGGGGEEEETTTT CCCCOOOOMMMMMMMMAAAANNNNDDDD
  80.      The llllaaaabbbbeeeellll command creates a new Tcl command whose name is _p_a_t_h_N_a_m_e.  This
  81.      command may be used to invoke various operations on the widget.  It has
  82.      the following general form:
  83.  
  84.           _p_a_t_h_N_a_m_e _o_p_t_i_o_n ?_a_r_g _a_r_g ...?
  85.  
  86.      _O_p_t_i_o_n and the _a_r_gs determine the exact behavior of the command.  The
  87.      following commands are possible for label widgets:
  88.  
  89.      _p_a_t_h_N_a_m_e ccccggggeeeetttt _o_p_t_i_o_n
  90.           Returns the current value of the configuration option given by      |
  91.           _o_p_t_i_o_n.  _O_p_t_i_o_n may have any of the values accepted by the llllaaaabbbbeeeellll    |
  92.           command.
  93.  
  94.      _p_a_t_h_N_a_m_e ccccoooonnnnffffiiiigggguuuurrrreeee ?_o_p_t_i_o_n? ?_v_a_l_u_e _o_p_t_i_o_n _v_a_l_u_e ...?
  95.           Query or modify the configuration options of the widget.  If no
  96.           _o_p_t_i_o_n is specified, returns a list describing all of the available
  97.           options for _p_a_t_h_N_a_m_e (see TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeIIIInnnnffffoooo for information on the
  98.           format of this list).  If _o_p_t_i_o_n is specified with no _v_a_l_u_e, then
  99.           the command returns a list describing the one named option (this
  100.           list will be identical to the corresponding sublist of the value
  101.           returned if no _o_p_t_i_o_n is specified).  If one or more _o_p_t_i_o_n-_v_a_l_u_e
  102.           pairs are specified, then the command modifies the given widget
  103.           option(s) to have the given value(s);  in this case the command
  104.           returns an empty string.  _O_p_t_i_o_n may have any of the values accepted
  105.           by the llllaaaabbbbeeeellll command.
  106.  
  107.  
  108. BBBBIIIINNNNDDDDIIIINNNNGGGGSSSS
  109.      When a new label is created, it has no default event bindings:  labels
  110.      are not intended to be interactive.
  111.  
  112.  
  113. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  114.      label, widget
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.